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OS/400 PASE Shells and Utilities 


OS/400"*) Portable Application Solutions Environment (OS/400 PASH) includes three shells (Korn, Bourne, 
and C Shell) and over 200 utilities that run as OS/400 PASE programs. OS/400 PASE shells and utilities 
provide an extensible scripting environment that includes a large number of industry-standard and 


defacto-standard commands. 


To become more familiar with OS/400 PASE shells and utilities, see the following topics. You can also find 
his release] and how you can 


information about What's new 


Using the shells and utilities 


A ee way to access OS/400 PASE shells and utilities is to call program [Run an OS/400 PASE Terminal 


(QP2TERM), which presents an interactive display with a command line that lets you enter 


OS/400 PASE commands. You can also call program 


any OS/400 PASE program, including a shell or utility. 


Bun-any 08/400 PASE pmgranl (QP2SHELL) to run 


Many OS/400 PASE utilities have the same name (with similar options and behavior) as QShell utilities in 
directory /usr/bin, so OS/400 PASE utilities are provided in directory /QOpenSys/usr/bin or 
/QOpenSys/usr/sbin. The OS/400 PASE PATH environment variable should generally include directories 
/QOpenSys/usr/bin, /QOpenSys/usr/bin/X11 and /QOpenSys/usr/sbin when running an OS/400 PASE shell. 


Soin any Caden PAGE aoe 


PASE environment variables. 


Overview of OS/400 PASE utilities 


See l0S/400 PASE Commandd for information about these OS/400 PASE utilities: 


admin dspcat 
aixterm dspmsg 
ajar du 

alias dump 
appletviewer echo 
apply ed 

ar edit 

as egrep 
attr env 

awk ex 
banner execerror 
basename expand 
be expr 
bdiff extcheck 
bfs false 

bg fc 

bsh fg 

cat fgrep 

cb file 

cd find 

cdc fold 
chgrp gencat 
chmod get 
chown getconf 
chroot getjobid 
cksum getopt 
clear getopts 
clrtmp grep 
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kill 
ksh 
ksh93 
ld 

lex 
line 

In 
locale 
locale64 
logger 
logname 
look 


make 
makekey 
mkcatdefs 
mkdir 
mkfifo 
mkfontdir 
mknod 
more 

mv 

mwm 
native2ascii 
nawk 
newform 


qsh 
qsh_inout 
qsh_out 
ranlib 
read 

red 
regcmp 
reset 
resize 
rev 

Rfile 

rgb 

rm 

rmdel 
rmdir 
rmic 

rmid 
rmiregistry 
rtl_enable 
runcat 
sact 

SCCS 
sccsdiff 
sdiff 

sed 
serialver 
setccsid 
setmaps 


(QP2SHELL) for information about setting initial values for OS/400 


time 
tnameserv 
touch 
tput 

tr 

trace 
trbsd 
trcoff 
trcon 
trcstop 
true 
tset 
tsort 
tty 

type 
ulimit 
umask 
unalias 
uname 
uncompress 
unexpand 
unget 
uni fdef 
uniq 
unpack 
untab 
val 

vc 


cmp hash nice sh vedit 


colrm head nl size vi 

comb hostname nm sleep view 
comm iconv nohup sort wait 
command id od split wc 
compress indent pack strings what 

cp install pagesize strip which 
cpio iperm paste stty X 

csh ipcs patch sum xargs 
csplit jar pax syslogd xauth 
cut jarsigner pcat system xhost 
date java pg sysval xlsfonts 
dbx javac policytool tab xmodmap 
dc javadoc pr tabs xset 

dd javah printenv tail xterm 
delta javakey printf tar xwd 
diff javap prs tee xwud 
diff3 jobs ps termdef yacc 
dircmp join psh test yes 
dirname keytool pwd tic zcat 


In addition to these utilities, each OS/400 PASE shell supports a number of built-in commands (such as 
cd, exec, if, etc.). See IAIX® documentation) for information about the built-in commands supported by 
each OS/400 PASE shell. 


The OS/400 PASE default shell ((QOpenSys/usr/bin/sh) is the Korn shell. 


fod | APIs by category) 


What’s new in V5R2 


Here are some of the significant enhancements and changes for OS/400 PASE in V5R2: 


e Pseudo terminal (PTY) support and UNIX-style job control. See [Pseudo terminal (PTY) for details. 
* Over 100 new utilities. See the (0 


* The following new libraries were added. See the [(O 


listing. 
libcur.a AIX legacy Curses library 
libg.a Debug support 
libgair4.a Internal X Windows support 
libl.a lex support 
libld.a Object File Access Routine library 
libm.a IEEE Math library 
libPW.a Programmers Workbench library 
libxcurses.a Curses library 
libXi.a X Windows input processing 
libXtst.a X Windows testing support 
liby.a yacc support 


¢ Anew message (MCH3204) appears in the job log for any unsupported system call used by an OS/400 
PASE program. This message text includes the name of the system call and the instruction address that 
caused the error. 


* New and changed lO : 
— _CVTERRNO (convert OS/400 PASE errno to ILE errno) 
— _ILECALLX (enhanced ILE procedure call) 

_PMGCALL (call an OS/400 program) 

_RETURN (return without exiting OS/400 PASE) 
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_RSLOBJ, _RSLOBUJ2 (resolve to an OS/400 object) 
_STRLEN_SPP, _STRCPY_SPP (string manipulation using 16-byte ILE pointers) 
Qp2paseCCSID (retrieve OS/400 PASE CCSID) 
Qp2jobCCSID (retrieve job default CCSID from last time OS/400 PASE CCSID set) 
faccessx 

fchdir 

fclear 

fclear 

getaddrinfo, getnameinfo 

getcontext, setcontext 

getpri, getpriority, setpriority 

getprocs64, getthrds64 

gettimer, settimer 

msem_init, msem_lock, msleep, msem_unlock, msem_remove 
pread, pwrite 

setgroups 

sigstack, sigaltstack (alternate signal stack) 

statpriv 

statvfs, fstatvfs 

sync 

ustat 


New and changed (ILE) IAPIs for OS/400 PASE: 


— QP2SHELL2 (like QP2SHELL, but runs in caller’s activation group) 
— Qp2ptrsize (retrieve OS/400 PASE pointer size) 
— Qp2paseCCSID (retrieve OS/400 PASE CCSID) 
— Qp2jobCCSID (retrieve job default CCSID when OS/400 PASE CCSID last set) 
— Qp2errnop (locate OS/400 PASE errno for current thread) 

— Qp2malloc (allocate OS/400 PASE heap memory) 
— Qp2free (free OS/400 PASE heap memory) 

— Qp2dlopen (dynamically load an OS/400 PASE module) 

— Qp2dlsym (find a symbol in a module opened by OS/400 PASE dlopen) 
— Qp2dlclose (close and unload a module loaded by OS/400 PASE dlopen) 
— Qp2dlerror (retrieve error information for the last dynamic load operation) 


— Qp2CallPase (and Qp2CallPase2) ehancements for by-address arguments and results, and to call 
an OS/400 PASE procedure in a thread that was not started by OS/400 PASE 


OS/400 PASE locales (and other files for globalization support) are now packaged with OS/400 
language feature codes; see 


Fiabaleatiacd ior details 


In addition, over 200 new files for X Windows 


ocessing of different keyboards and character sets, plus the following 65 new locales. See the 


PASE Localad 


topic for a complete listing. 


AR_AE.UTF-8 ES CO.UTF-8 de_AT.8859-15 
AR_BH.UTF-8 ES MX.UTF-8 de_AT.8859-15@euro 
AR_EG.UTF-8 ES PE.UTF-8 de_LU.8859-15 
AR_JO.UTF-8 ES_PR.UTF-8 de_LU.8859-15@euro 
AR_KW.UTF-8 ES _UY.UTF-8 en_CA.8859-15 
AR_LB.UTF-8 ES VE.UTF-8 en_IE.8859-15 
AR_OM.UTF-8 FR_LU.UTF-8 en_IE.8859-15@euro 
AR_QA.UTF-8 FR_LU.UTF-8@euro en_IN.8859-15 
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AR_SA.UTF-8 HI_IN.UTF-8 en_NZ.8859-15 
AR_SY.UTF-8 SH_YU.UTF-8 es_AR.8859-15 
AR_TN.UTF-8 SR_YU.UTF-8 es_CL.8859-15 
DE_AT.UTF-8 ar_AE.1S08859-6 es_C0.8859-15 
DE_AT.UTF-8@euro ar_BH.1S08859-6 es_MX.8859-15 
DE_LU.UTF-8 ar_EG.1S08859-6 es_PE.8859-15 
DE_LU.UTF-8@euro ar_J0.1S08859-6 es_PR.8859-15 
EN_CA.UTF-8 ar_KW.1S08859-6 es_UY.8859-15 
EN_IE.UTF-8 ar_LB.1S08859-6 es_VE.8859-15 
EN_IE.UTF-8@euro ar_0M.1S08859-6 fr_LU.8859-15 
EN_IN.UTF-8 ar_QA.1S08859-6 fr_LU.8859-15@euro 
EN_NZ.UTF-8 ar_SA.1S08859-6 sh_YU.1S08859-2 
ES_AR.UTF-8 ar_SY.1S08859-6 sr_YU.1S08859-5 
ES_CL.UTF-8 ar_TN.1S08859-6 


How to see what’s new or changed 


To help you see where technical changes have been made, this information uses: 
* The # image to mark where new or changed information begins. 
* The *€ image to mark where new or changed information ends. 


To find other information about what’s new or changed this release, see the [Memo to Users eo . 
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To view or download the PDF version, select |O 
or 24 pages). 


J information (about 119 KB 


Saving PDF files 


To save a PDF on your workstation for viewing or printing: 

1. Right-click the PDF in your browser (right-click the link above). 

2. Click Save Target As... 

3. Navigate to the directory in which you would like to save the PDF. 
4. Click Save. 


Downloading Adobe Acrobat Reader 


If you need Adobe Acrobat Reader to view or print these PDFs, you can download a copy from the [Adobd 
Web site] (www.adobe.com/products/acrobat/readstep. html) a3 . 


OS/400 PASE Commands 


Most OS/400 PASE commands support the same options and provide the same behavior as AIX 
commands, except in these areas: 


* 2 Many OS/400 PASE commands for display operations and UNIX(TM) job control only work in a TTY 
session such as a session started by the aixterm or xterm command. These functions do not work on 
5250 workstation devices (including the display presented by program QP2TERM). *& 


* OS/400 PASE generally does not support interfaces provided on AIX for system management. For 
example, OS/400 PASE provides no support for the AIX System Managment Interface Tool (SMIT) and 
does not support functions that require a SMIT database. 
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* OS/400 is fundamentally an EBCDIC system. OS/400 PASE shells and utilities run in ASCII and 
generally do no automatic conversion of stream data. You may need to use tools such as the iconv 
utility to convert between ASCII and EBCDIC encoding. 


Unlike the QShell interpreter and utilities, most OS/400 PASE shells and utilties do no automatic Coded 
Character Set Identifier (CCSID) conversion of stream file data. The OS/400 PASE utilities lsystem, and 
any OS/400 PASE utility that runs a QShell command are exceptions because they provide CCSID 
conversion support for data the CL command or QShell command reads from standard input or writes to 
standard output or standard error. 


2 OS/400 PASE utilities that run QShell Java™ utilities (such as the java command) set the Java 
file.encoding property to match the OS/400 PASE CCSID, so that stream data read and written by the 
Java program is converted from and to the OS/400 PASE CCSID. You can force a specific 
file.encoding value by setting OS/400 PASE environment variable PASE_JAVA_ENCODING before 


running the utility. 


* OS/400 uses case-insensitive names for many system resources that have case-sensitive names in AIX 
(user and group names, object names in the root file system, etc.). Some OS/400 PASE shell and utility 
functions require matching case for resources that have case-insensitive names in OS/400, and others 
may return names in uppercase that would normally be lowercase on AIX. For example, file name 
expansion in OS/400 PASE shells is case-sensitive, so you must specify uppercase to match generic 
names in the /QSYS.LIB file system: 

ls /qsys.1ib/qgp].1ib/GEN*.PGM 
rather than 
ls /qsys.lib/qgp1.1ib/gen*.pgm 

* To provide case-sensitivity and avoid name collisions with directories and files used for ILE support, 
most OS/400 PASE directories and files (including shells and utilities) are stored in the /QOpenSys file 
system. In particular, OS/400 PASE shells and utilities are in /QOpenSys/usr/bin and 
/QOpenSys/usr/sbin (rather than /usr/bin and /usr/sbin on AIX). 


In addition to the OS/400 PASE commands listed below, each OS/400 PASE shell supports a number of 
built-in commands (such as cd, exec, if, etc.). See for information about the built-in 
commands supported by each OS/400 PASE shell and for detailed information about most of these 
OS/400 PASE commands: 


A (see page A) B ( ve page )c (see page aay see page a E (see page BF is (see page 4s (see page 
id) H (see page iZ) | (see page in J (see ae (see page |g) L (see page (see page |g) N (see 


page |8) O (see page d) P (see page lh a (see page Q) R (see pa elg) S (see pa e [Lah T (see pa e 1d) 
ia) ti it) i} 


U (see page hl) V (see page W (see page IL1l) X (see page IL1l) Y (see page Z (see page 
A 

2 admin Create and control Source Code Control System (SCCS) 
files 

= aixterm Initialize an Enhanced X-Windows terminal emulator *& 

= bjal Run the QShell ajar command, which is the alternative 
Java archive tool 

alias Define or display aliases 

=> ppletviewer Run the QShell appletviewer command, to run Java 
applets without a web browser & 

apply Apply a command to a set of parameters 

ar Maintain the indexed libraries used by the linkage editor 

» as Run the assembler *& 

> bttd Run the QShell attr command to display or change 


Integrated File System object attributes « 
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awk 


banner 


basename 
be 


bdiff 


bfs 
bg 
bsh 


cat 
cd 


= ede 
chgrp 

chmod 
chown 
chroot 
cksum 


= clear 
2 [cirtmyl 


cmp 
colrm 

= comb 
comm 
command 
compress 
cp 

cpio 

csh 

csplit 

cut 


date 
dbx 


dc 


dd 

diff 
diff3 
dircmp 


dirname 
dspcat 
dspmsg 


du 
dump 
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Find lines in files matching patterns and then perform 
specified actions on them 

B 

Write ASCII character strings in large letters to standard 
output 

Return the base filename of a string parameter 
Provide an interpreter for arbitrary-precision arithmetic 
language 

Use the diff command to find differences in very large 
files 

Scan files 

Run a job in the background 

Invoke the Bourne shell 

Cc 

Concatenate or display files 

Change the current directory 


Change the comments in a SCCS delta & 
Change the group ownership of a file or directory 
Change permission modes 

Change the user associated with a file 

Change the root directory of a command 

Display the checksum and byte count of a file 


Clear the terminal screen *& 
Run the QShell clrtmp command to clear directory /tmp 
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Compare two files 
Extract columns from a file 


Combine SCCS deltas 

Select or reject lines common to two sorted files 
Execute a simple command 

Compress data 

Copy files 

Copy files into and out of archive storage and directories 
Invoke the C shell 

Split files by context 

Write out selected bytes, characters, or fields from each 
line of a file 

D 

Display or set the date or time 

Provide an environment to debug and run OS/400 PASE 
programs 

Provide an interactive desk calculator for 
arbitrary-precision integer arithmetic 

Convert and copy a file 

Compare text files 

Compare three files 

Compare two directories and the contents of their 
common files 

Write to standard output all but the last part of a specified 
path 

Display all or part of a message catalog 

Display a selected message from a message catalog 
Summarize disk usage 

Dump selected parts of an object file 

E 


echo 


= ed 
= edit 


egrep 
env 


a ex 


execerror 
expand 
expr 


2 lextchecK 


false 
fc 

fg 
fgrep 
file 
find 
fold 


= gencat 
= get 


getconf 


* Igetiobid 


getopt 
getopts 


grep 

hash 
head 
hostname 
iconv 

id 


2 indent 
install 


# lipes 

* liperml 

2 lial 

> llarsigned 
> [aval 


Write character strings to standard output 
Edit text by line 


Provide a simple line editor for the new user *& 

Search a file for a pattern 

Display the current environment or set the environment for 
the execution of a command 

Edit lines interactively, with a screen display € 

Write error messages to standard error 

Write to standard output with tabs changed to spaces 
Evaluate arguments as expressions 

Run the QShell extcheck command, to detect Java 
archive conflicts * 

F 

Return a nonzero exit value (false) 

Process the command history list 

Run jobs in the foreground 

Generate the figure list in a format supported by the build 
process 

Determine file type 

Find files with a matching expression 

Fold long lines for finite-width output device 

G 


Create and modify a message catalog € 


Create a specified version of a SCCS file & 

Write system configuration varible values to standard 
output 

Run the QShell getjobid command to determine the 
OS/400 job name for a process identifier = 

Parse command line flags and parameters 

Process command-line arguments and check for valid 
options 

Search a file for a pattern 

H 

Remember or report command path names 

Display the first few lines or bytes of a file or files 

Set or display the name of the current host system 

I 

Convert the encoding of characters from one code page 
encoding scheme to another 

Display the system identifications of a specified user 


Reformat a C language program « 

Install a command 

Run the QShell ipes command to display interprocess 
communications objects & 

Run the QShell iperm command to remove interprocess 
communications objects € 

J 

Run the QShell jar command, to archive Java files 
Run the QShell jarsigner command, to sign or verify the 
signature of a Java archive € 

Run the QShell java command, to run the Java interpreter 


% 
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# flavadl 
# [javadod 
2 [aval 
2 [avakeyl 
# [avap 


jobs 
join 


2 keytool 


kill 
ksh 
= ksh93 


Id 
2 lex 


line 

In 

locale 
logger 
logname 


= look 
2 lorder 


Is 


a m4 
2=* make 
a makekey 


2 mkcatdefs 
mkdir 
mkfifo 


2° mkfontdir 
mknod 


a more 


mv 


eS mwm 
# Inative2ascii 


nawk 
newform 


= nice 


nl 
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Run the QShell javac command, to compile a Java 
program *& 

Run the QShell javadoc command, to generate Java 
documentation *& 

Run the QShell javah command, to generate C header or 
stub files for Java classes *& 

Run the QShell javakey command, to manage Java 
security keys € 

Run the QShell javap command, to disassemble a 
compiled Java program € 

Display status of jobs in the current session 

Join the data fields of two files 

K 

Run the QShell keytool command, to manage keys and 
certificates for Java *& 

Send a signal to running processes 

Invoke the Korn shell 


Invoke the enhanced Korn shell *& 
L 


Link object files * 

Generate a C or C++ language program that matches 
patterns for simple lexical analysis of an input stream *& 
Read one line from the standard input 

Link files 

Write information about current locale or all public locales 
Make entries in the system log 

Display login name 

Find lines in a sorted file *% 

Find the best order for member files in an object library 
« 

Display the contents of a directory 

M 

Preprocess files, expanding macro definitions 


Maintain, update, and regenerate groups of programs «& 
Generate an encryption key = 


Preprocess a message source file * 
Create one or more new directories 
Make first-in-first-out (FIFO) special files 


Create a fonts.dir file from a directory of font files « 
Create a special file 


Display the contents of files one screen at a time « 
Move files 


Run the AlXwindows‘® Window Manager (MWM) #& 
N 

Run the QShell native2ascii command, to convert 
characters encoded in the OS/400 PASE CCSID to 
Unicode encoding <= 

Invoke the new version of awk 

Change the format of a text file 


Run a command at a lower or higher priority € 
Number lines in a file 


nm 
nohup 


od 


pack 
pagesize 
paste 


patch 
pax 


pcat 
2 pg 
% policytoal 


pr 
printenv 
printf 


» prs 
ps 
psh 
pwd 


igs 
2 qsh_inoul 
2 Iqsh_oudl 


= ranlib 
read 


2 red 
eS regcmp 
= reset 


2 resize 


rev 


2 file 
e rgb 


rm 


= rmdel 
rmdir 


# imid 
# imid 
2 lmiragistry 


bo rtl_enable 


Display the symbol table of an object file 

Run a command without hangups 

oO 

Display files in a specified format 

Pp 

Compress files 

Display the system page size 

Merge the lines of several files or subsequent lines in one 
file 

Apply changes to files 

Extract, write, and list members of archive files; copy files 
and directory hierarchies 

Unpack files and write them to standard output 

Format files to the display 

Run the QShell policytool command, to create and 
manage Java policy files « 

Write a file to standard output 

Display the values of environment variables 

Write formatted output 

Display a Source Code Control System (SCCS) file *& 
Show current status of processes 

Invoke the POSIX (Korn) shell 

Display the pathname of the working directory 

Q 

Run a QShell command *& 

Run a QShell command *& 

Run a QShell command *& 

R 

Convert archive libraries to random libraries *& 

Read one line from standard input 

Edit text by line 

Compile patterns into C language char declarations « 
Initialize a terminal *& 

Set the TERMCAP environment variable and terminal 
settings to the current window size « 

Reverse characters in each line of a file 

Run the QShell Rfile command to read or write OS/400 
record files 

Create the database used by the X-Window system server 
for colors *& 

Remove (unlink) files or directories 

Remove a delta from a SCCS file 

Remove a directory 

Run the QShell rmic command, to compile Java RMI 
stubs & 

Run the QShell rmid command, to run the Java RMI 
activation system « 

Run the QShell rmiregistry command, to start a Java 
remote object registry < 

Relink shared objects to enable the runtime linker to use 


them & 
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= runcat 


= sact 
2 serialved 


= sccs 
= secsdiff 
= sdiff 


sed 


a setmaps 
2 setccsid 


sh 
2 size 


sleep 
sort 


split 
strings 
strip 


= stty 


sum 
syslogd 


2 Isysvall 


tab 
= tabs 


tail 


tar 
tee 
test 


# tic 


time 


# itnameserv 


touch 


oa tput 


tr 

* trace 
= trbsd 
# treoff 
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Pipe output data from the mkcatdefs command to the 


gencat command € 
Ss 


Display current SCCS file-editing status € 
Run the QShell serialver command, to return the version 


number for Java classes *& 
Administration program for SCCS commands *& 


Compare two versions of a SCCS file * 
Compare two files and display the differences in a 
side-by-side format € 

Provide a stream editor 


Set terminal maps or code set maps € 

Run the QShell setccsid command to set the CCSID for 
an Integrated File System object « 

Invoke the default (Korn) shell 

Display the section sizes of the Extended Common Object 
File Format (XCOFF) object files *& 

Suspend execution for an interval 

Sort files, merge files that are already sorted, and check 
files to determine if they have been sorted 

Split a file into pieces 

Find the printable strings in an object or binary file 
Reduce the size of an Extended Common Object File 
Format (XCOFF) object file by removing information used 
by the binder and symbolic debug program 

Set, reset, and report workstation operating parameters 
« 

Display the checksum and block count of a file 

Log system messages 

Run a CL command 

Run the QShell sysval command to display an OS/400 
system value or network attribute 

T 

Change spaces into tabs 


Set tab stops on a terminal € 

Write a file to standard output, beginning at a specified 
point 

Manipulate archives 

Display the output of a program and copy it into a file 
Evaluate conditional expressions 

Translate the terminfo description files from source to 
compiled format « 

Print the time of the execution of a command 

Run the QShell thameserv command, to provide access 
to the Java naming service € 

Update the access and modification times of a file 
Query the terminfo database for terminal-dependent 
information *& 

Translate characters 


Record selected system events & 
Translate characters (BSD version) *& 
Stop the collection of trace data « 


= trcon 


= trestop 
true 


2 tset 
# tsort 


= tty 
type 


ulimit 
umask 
unalias 
uname 
uncompress 
unexpand 


= unget 


= unifdef 
uniq 
unpack 
untab 


= val 
2 ve 
= vedit 
2 vi 

= view 


wait 
wc 
what 
which 


= xX 


xargs 
= xauth 


= xhost 


= xIsfonts 
» xmodmap 
= xset 

= xterm 

= xwd 

= xwud 


= yacc 


Start the collection of trace data *& 


Stop the trace function 
Return an exit value of zero (true) 


Initialize a terminal *& 

Sort an unordered list of ordered pairs (a topological sort) 
< 

Write to standard output the full path name of your 
terminal 

Write a description of the command type 

U 

Set or report user resource limits 

Display or set the file mode creation mask 

Remove alias definitions 

Display the name of the current operating system 
Restore compressed files 

Write to standard output with tabs restored 

Cancel a previous SCCS get command *& 

Remove ifdef lines from a file *& 

Delete repeated lines in a file 

Expand files 

Change tabs into spaces 

Vv 

Validate SCCS files “& 

Substitute assigned values for identification keywords « 
Edit files with a full-screen display *& 

Edit files with a full-screen display *& 

Start the vi editor in read-only mode = 

WwW 

Wait until the termination of a process ID 

Count the number of lines, words, and bytes in a file 
Display identifying information in files 

Locate a program file, including aliases and paths (the csh 
(C shell) command only) 

xX 

Run the X server. OS/400 PASE only supports virtual 


frame buffer processing & 
Construct a parameter list and run a command 
Edit and display the authorization information used in 


connecting to the X server « 
Control who accesses Enhanced X-Windows on the 


current host machine *& 

Display the font list for X-Windows *& 

Modify keymaps in the X Server *& 

Set options for your X-Windows environment « 

Provide a terminal emulator for the X Window System & 
Dump the image of an Enhanced X-Windows window « 
Retrieve and display the dumped image of an Enhanced 


X-Windows window *& 
Y 
Generate an LALR(1) parsing program from input 


consisting of a context-free grammar specification = 


OS/400 PASE Shells and Utilities 11 


yes Output an affirmative response repetitively 
Zz 
zcat Expand a compressed file to standard output 


system - Run a CL Command for OS/400 PASE 


Syntax 
system [-beEhiIkKnOqsv] CL-command [ CL-parameters ... ] 


Description 


The OS/400 PASE system utility runs a CL command. By default, any spooled output produced by the 
command is written to standard output, and any messages sent by the command are written to standard 
output or standard error (depending on whether the CL command sent an exception message). 


You need to set ILE environment variable QIBM_USE_DESCRIPTOR_STDIO to Y or | (so that OS/400 
PASE runtime and ILE C runtime use descriptor standard |/O) to avoid unpredicatable results. This is done 
by default in the OS/400 jobs that program QP2TERM uses to run OS/400 PASE shells and utilities. 


Options 


-b Force binary mode for standard streams used by the CL command. When this option is omitted, 
the system command converts any data the CL command reads from standard input from the 
OS/400 PASE CCSID to the job default CCSID, and converts data written to standard output or 
standard error from the job default CCSID to the OS/400 PASE CCSID. This option avoids CCSID 
conversion for all standard streams except those associated with any of the options -E, -I, and -O. 


-e Copy OS/400 PASE environment variables to ILE environment variables before running the CL 
command. When this option is omitted, no ILE environment variables are set, so the ILE 
environment may be be missing variables or have different variable values than the OS/400 PASE 
environment. 


For most variables, the copy has the same name as the original, but the system adds a prefix 
"PASE_” to the name of the ILE copy of some environment variables. You you can control what 
variables add the name prefix by storing a colon-delimited list of variable names in OS/400 PASE 
environment variable PASE_ENVIRON_CONFLICT, or the system defaults to adding the prefix 
when copying OS/400 PASE environment variables SHELL, PATH, NLSPATH, and LANG. 


Any OS/400 PASE environment variable name with a prefix "ILE_” is copied to the ILE 
environment twice. The first copy uses the same variable name, and the second copy uses the 
name without the prefix. For example, if the OS/400 PASE environment contains a variable named 
ILE_PATH, the value of this variable is used to set both ILE_PATH and PATH in the ILE 
environment. 


2*-E Force CCSID conversion for the standard error stream used by the CL command. When this 
option is specified, the system command converts any data the CL command writes to standard 
error from the job default CCSID to the OS/400 PASE CCSID. This option overrides option -b for 


the standard error stream. 
-h Write a brief description of allowable syntax for the system command to standard output. 


-i Run the CL command in the same process (OS/400 job) where the system utility runs. When 
option -i is omitted, the CL command is run in a separate process (created using the ILE spawn 
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-K 


-n 


-q 


-S 


“Vv 


API) that is not multithread-capable and is not running an OS/400 PASE program. Many CL 
commands are not supported in a multithreaded job. 


Force CCSID conversion for the standard input stream used by the CL command. When this 
option is specified, the system command converts any data the CL command reads from standard 
input from the OS/400 PASE CCSID to the job default CCSID. This option overrides option -b for 
the standard input stream. CCSID conversion should only be used for standard input if the CL 
command reads standard input because processing done by the system command attempts to 
read and convert all standard input data regardless of whether the CL command uses the data, so 


it may leave the standard input stream positioned beyond what the CL command read. 


Keep all spool files generated by the CL command. When this option is omitted, spooled output 
files are deleted after their contents is written as text lines to standard output. Option -i has no 
effect when option -s is used. 


Force a job log for the OS/400 job where the CL command runs. If this option is omitted, a job log 
may only be produced if an unexpected error occurs. 


Do not include OS/400 message identifiers in any text line written to standard output or standard 
error for a message sent by the CL command. When this option is omitted, the format of any text 
lines written for OS/400 pre-defined messages is "XXX1234: message text”, where "XXX1234" is 
the OS/400 message identifier. -n suppresses the message identifier, so only "message text” is 
written to the stream. Option -n has no effect when option -q is used. 


Force CCSID conversion for the standard output stream used by the CL command. When this 
option is specified, the system command converts any data the CL command writes to standard 
output from the job default CCSID to the OS/400 PASE CCSID. This option overrides option -b for 


the standard output stream. *& 


Do not write any text lines to standard output or standard error for OS/400 messages sent by the 
CL command. If this option is omitted, messages sent by the CL command are received, 
converted from the job default CCSID to the OS/400 PASE CCSID, and written as a text lines to 
standard output or standard error, depending on whether the CL command sent an exception 
message. 


Do not process spooled output files produced by the CL command. When this option is omitted, 
spooled output generated by the CL command is converted from the job default CCSID to the 
OS/400 PASE CCSID and written to standard output, and then the spooled output files are 
deleted. 


Write the complete CL command string to standard output before running the CL command. 


Operands 


CL-command is concatenated with any CL-parameters operands (with a single space between them) to 
form the CL command string. You may need to enclose CL command and parameter values in quotes to 
prevent the OS/400 PASE shell from expanding special characters (such as parentheses and asterisks). 


If a CL command parameter value requires quotes (such as a text parameter with lowercase characters or 
embedded blanks), you must specify those quotes inside a quoted string because OS/400 PASE shells 
remove the outer quotes from any argument passed to the OS/400 PASE system utility. 


Exit Status 


0 
>0 


The CL command completed successfully. 


The CL command either could not be run or ended in error (Sent an exception message to the 
caller). Error messages may have been sent to standard output, or may appear in the job log of 
the OS/400 job that ran the command. 
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Examples 


This example shows three ways to run the CRTDTAARA CL command with the same parameter values. 
Options -bOE force CCSID conversion for standard output and standard error (but not standard input). The 
"*char” parameter value must be quoted to prevent the OS/400 PASE shell from expanding it as a set of 
file names, and the TEXT parameter requires two sets of enclosing quotes because it contains lowercase 
and embedded blanks: 

system -bOE "crtdtaara mydata *char text('Output queue text')" 
or 

system -bOE crtdtaara mydata "*char text('Output queue text')" 
or 

system -BOE crtdtaara mydata '*char' "text('Output queue text')" 


This example shows how the system utility can run the CALL CL command to call a program that accepts 
two parameters. Option -i avoids the overhead of creating an additional process to run the CL command. 
Since no other options are specified, CCSID conversion is done for standard input, standard output, and 
standard error. The called program sees the first parameter converted to uppercase (ARG1) and the 
second parameter unchanged (arg2) because of the rules of CL: 


system -i "call mypgm (argl ‘arg2')" 


qsh, qsh_inout, qsh_out - Run a QShell Command for OS/400 PASE 


Syntax 
qsh [command-options] 


qsh_inout [command-options] 


qsh_out [command-options] 


Description 


= The OS/400 PASE qsh, qsh_inout, and qsh_out commands run a QShell command. These 
commands use the OS/400 PASE system command to copy OS/400 PASE environment variables to the 
ILE environment and then call the QShell command program through a link in directory /usr/bin. 


The OS/400 PASE qsh, qsh_inout, and qsh_out commands all provide the syntax and behavior of the 
QShell qsh command, with additional support for ASCII/EBCDIC conversion of standard I/O provided by 
the OS/400 PASE system command. Any other command name that links to OS/400 PASE qsh, 
qsh_inout, or qsh_out (in directory /QOpenSys/usr/bin) provides the same syntax and behavior as the 
QShell command in directory /usr/bin with the same base name as the link. See the following topics for 
more information: 


The qsh and qsh_inout commands do ASCII/EBCDIC conversion for standard input, standard output, and 
standard error. The qsh_out command only does ASCII/EBCDIC conversion for standard output and 


standard error. 
You need to set ILE environment variable QIBM_USE_DESCRIPTOR_STDIO to Y or | (so that OS/400 


PASE runtime and ILE C runtime use descriptor standard I/O) to avoid unpredicatable results. This is done 
by default in the OS/400 jobs that program QP2TERM uses to run OS/400 PASE shells and utilities. 
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See the following topics for related information: 


Examples 


= You should use qsh_out (instead of qsh or qsh_inout) when the QShell command does not read from 
standard input to avoid unintended repositioning of the input stream. This example uses qsh_out to avoid 
repositioning the stream processed by the read command, and simply echos the contents of file "myinput” 
to standard output: 

while read ; do 


qsh_out -c “echo $REPLY" 
done < myinput 


This example uses the QShell cat command to convert text in an OS/400 source database file to the 
(ASCII) OS/400 PASE CCSID and store the result in a stream file named ascii_salcli.h. This takes 
advantage of support in the QShell utility to insert linend characters in the stream that are not added if the 
OS/400 PASE cat command is used: 


qsh_out -c ‘cat /qsys.lib/qsysinc.1ib/h.file/sqicli.mbr' > ascii_sqlcli.h 


The system provides an OS/400 PASE getjobid command using symbolic link /QOpenSys/usr/bin/getjobid 
-> qsh_out to run the QShell getjobid command. This example shows two ways to run the QShell utility to 
determine the name of the OS/400 job running the OS/400 PASE shell. The first example is more efficient 
because it avoids running QShell interpreter. Variable $$ is expanded by the OS/400 PASE shell (to the 
process identifier of the shell), and the QShell getjobid command writes a line to standard output: 


getjobid $$ 


qsh_out -c "/usr/bin/getjobid $$" 


OS/400 PASE Shells and Utilities 15 


16 iSeries: OS/400 PASE Shells and Utilities 


Printed in U.S.A. 


